It is designed to allow quick and easy access to applications, Control Panels, Desk Accessories, Folders and other documents stored on your Macintosh, without having to navigate through several メFinder Windowsモ or through a multi-layered, hierarchical Apple menu.
It works by clicking on icons installed in a floating window, or dropping documents onto them. This approach is much handier than aliases that are on the desktop because the floating windows that contain the icons can never be covered by windows. HandyMan also requires a lot less desktop space than the same number of icons on the desktop.
2. System Requirements
HandyMan can run on any Macintosh model, and requires at least System 7.1 and Control Strip installed.
Make sure the メFinder Scripting Extensionモ version 1.2 is installed to work with Folder icons, Trash icons, Control Panel icons, and ordinary documents ...
If Drag Manager 1.1 is installed you can drag and drop documents on the applications, folders and Trash icons in the strip (Mac OS version 7.5 has the Drag Manager included).
For best functionality you need System 8.5 with メControl Stripモ (version 2.0 or higher) installed, or with メExtensions Stripモ (version 1.9 or higher) installed.
Should you have any trouble running HandyMan on your machine, please write to me with the full specifications of your machine and what version of HandyMan you are using, as well as the name and version of the strip module you have installed.
3. Installing HandyMan
1. Install the Apple Control Strip control panel, or an alternative such as Extensions Strip. If you use a desktop Mac, you must have at least version 1.3 of Apple's Control Strip (earlier versions only worked on portable Macs). For increased functionality, use Extensions Strip.
2. Place HandyMan inside the Control Strip Modules folder, which is inside the System Folder. It may be named differently on non-English systems. If you have used the メAdd Aliasモ script from old version of HandyMan, then you should remove it, as it is no longer required.
3. Restart your Macintosh to install HandyMan. This restart is not needed for Extensions Strip users.
Note: this is no longer true since MacOS 8.5. Just drop HandyMan onto the strip to install it.
4. Configure HandyMan by dropping aliases into the メHandyMan Aliasesモ folder, or by dropping files onto the メ+モ icon at the start of each column/row. Or drop a file between 2 existing ones. If you click on the メ+モ icon in your strip, it will open the メHandyMan Aliasesモ folder (or the folder for that column/row if you are using Extensions Strip). Removing icons is done by dragging them to the Trash or by selecting メDelete Iconモ from the Icon Menu. Control Strip should update to Control Strip 2.0 which is part of MacOS 8.5 (see Known problem 2).
5. If you are using Extensions Strip, you can have multiple floating windows. All you need to do is have multiple folders inside your Strip Modules folder in your System folder. There will be one strip on your screen for each folder you create. For a typical setup, you would have one folder containing controls that you would typically put into Apple's Control Strip. A second folder would contain the Process Manager module that is distributed with Extensions Strip. A third or fourth (or fifth) could each contain copies of HandyMan set up in different ways. A single strip containing an alias of the Trash will always float above other windows, so you can always find the Trash.
6. Optionally drop the HandyMan Guide in the Extensions Folder to be get help in the finder under the Help Menu. Otherwise drop it at the same place as where HandyMan is to access help via the HandyMan configuration Menu.
4. Using Modifier keys
There are a few simple modifier keys that can be used:
Text Labels:
□ clicking on a text label allows you to resize the labels by dragging them Left or Right.
Shift selecting メShow TextLabelsモ from the preference menu puts the labels under the icons.
Option selecting メShow TextLabelsモ from the preference menu shows only the Labels.
Trash:
Option click on the Trash will empty it.
Folders:
Option drop on a folder copies the files to that folder, otherwise they will be moved.
□ clicking on a folder icon filters out non-folder items from that popup menu.
Shift clicking on a folder icon filters out folders from that popup menu.
□ dropping on a folder will force the copy or move to happen (no dialog popping up if the file already exists).
□ key wil force finder info for selection of folder menu item.
Clippings:
Shift clicking on a clipping copies it to the clip-board.
Shift selecting it from a popup menu copies the content to the clip-board.
Configuration:
Option dropping onto a メ+モ icon moves the file into the folder, instead of creating an alias of it.
5. Advanced Usage
Use compiled Apple Scripts, onto which you can drag and drop just like onto an application, to add custom commands to the strip.
sample usage:
on run
-- User has clicked the script to run it....
end run
on open theList
-- User has dropped files onto script to open them....
repeat with x in theList
-- walk through the list of dropped items
end repeat
end open
6. Localization (Catalog files)
For Localization HandyMan has support for catalog files. If HandyMan can find a file HandyMan.Catalog in it's folder or in the preference folder it will use it for translating everything into the language described in that catalog file (Finder Info shows language and version number of the catalog file).
If your HandyMan does not get translated you should check that both HandyMan and the Catalog have the same version number.
Note: Localization can mean the ヤRecent Documentsユ folder is renamed to match that of the localized system. If you can't get ヤRecent Documentsユ to work please see the ReadMe in the catalog folder of your active catalog (See also Enable Items Popup in The Configuration menu).
Check http://gallery.uunet.be/bwynants/mac/HandyMan.html for newer or updated catalogs.
7. The Configuration menu
Small icon size
This option is only available in Extensions Strip!
This displays small icons, that take up a lot less space on your desktop ミ a real space saver. If you would like mini sized icons, send me a letter with your comments.
Large icon size
This option is only available in Extensions Strip!
These icons are the same size as normal desktop icons, but they can be a lot closer together. If you would like mini sized icons, send me a letter with your comments.
Show Popup Triangle
HandyMan has the ability to hide the configuration triangle to save some space on your desktop (or because it's neater without that triangle).
You can always use Control click on the module to make it show its configuration menu and change the settings.
Show Vertical icon list
This option is only available in Extensions Strip!
The list of icons can be arranged horizontally or vertically.
Show Multiple Rows/Columns
This option is only available in Extensions Strip!
In the Configuration menu you will see either メShow Multiple Rowsモ or メShow Multiple Columnsモ. The option displayed depends on how you have set the メShow Vertical icon listモ option in the Configuration menu. To make multiple columns you can put a number of folders in the メHandyMan Aliasesモ folder and select the メShow Multiple Rows/Columnsモ option. This way folders are parsed one level deep, folders in those folders don't show up as additional rows/columns but as folders icons in the bar (for more information see the sample pictures included in the Examples document).
ハ
To completly suppress the adding of a folder make the first character of its name a ヤツユ (Option-L) (e.g. モツDisabled Itemsモ).
Since HandyMan 1.4 you can select the "Add Row" or "Add Column" menuitem for easier creation of multiple rows/columns (see メAdd Row/Columnモ).
Show InfoBar
This option is only available in Extensions Strip!
Let HandyMan tell you what item the mouse is over.
ハ
Show PopInfo
Text showing the name of the icon under the mouse pops up when you keep the pointer steady over a HandyMan icon for a few moments. The text always pops up inside the strip module's bounds. This method requires less screen space than the InfoBar, and works with Apple's Control Strip.
ハ
Show TextLabels
Icons are shown with the name next to them.
Option selecting this menu item removes the icon and only a text label will be shown. To resize the text labels, click in them with the □ key pressed. A vertical line will appear that can be dragged to the left or right.
ハ
Extensions Strip users can Shift select this menu item to put the text label under the icon.
Show Entry Tiles
This option is only available in Extensions Strip!
Entries are shown with a small 3D frame. (Including the text labels)
This option is only for nicer drawing and has for the rest no effect whatsoever...
ハ
Show Icon Tiles
This option is only available in Extensions Strip!
Icons are shown with a small 3D frame and the Icons behave like buttons.
(Clicking anyware in the Icon selects the Icon.)
ハ
Show Aliases Folder
A "+" icon is added to the start of the strip onto which you can drop icons to add them to the strip. With a normal drop, an alias is created, then put in the configuration folder. If you hold the Option key down while you drop the icon, the item is moved to that location. If an icon drag is started on the strip, by default, the alias is moved to the new row. The Option key changes this into a copy. To remove an icon, drag it to the Trash. If you are not using Extensions Strip, then read Known problem 2.
ハ
Resolve Dragged Alias
This only applies to installed applications. It is a toggle for applications to open the alias or the document the alias refers to.
Enable Items Popup
Enable this option then click and hold On an item in HandyMan a context sensitive menu will show up. Some available commands are Launch, Bring to front, Show Original, Finder Info and Delete Icon.
On a folder HandyMan additionally lets you select a file that is in that folder.
On applications HandyMan will list all items from the Favorites folder that can be handled by the application, next it will add all items from the Recent Documents folder that can be handled by the application.
To enable the Recent Documents folder you have to use the ヤApple Menu Optionsユ control panel and put a number in the ヤDocumentsユ option from ヤRemember recently used itemsユ
You can also make the ヤRecent Documentsユ folder yourself and put it in the ヤApple Menu Itemsユ folder or into the System folder. If you put some aliases to documents in it. The documents will popup on applications if you click and hold the mouse for a few moments over an application.
You also can lock or label aliases in that those folders to make it easier to spot them in HandyMan (See also Known problem 1).
TIP: If you use a localized version of the ヤApple Menu Optionsユ control panel and you don't have a Catalog for HandyMan in that language you can make an alias to your localized ヤRecent Documentsユ folder and that alias has to be put into the System folder with the name ヤRecent Documentsユ (or the name described in the active catalog). If HandyMan doesn't find the ヤRecent Documentsユ in the ヤApple Menu Itemsユ folder it will try to find it in the System folder and will resolve your alias to the correct folder.
Enable Drag Away
This requires メMacintosh Drag and Dropモ version 1.1 or higher to be installed.
This option must be on before you can drag items from the strip. Then you can drag them to the Trash or desktop to remove them from the strip. This is handy if you have an alias installed for the ヤFind Originalユ script from Apple. You can drag items from HandyMan to this script, and the script will show you where the original file is located. If you are not using Extensions Strip or Control Strip 2.0 (part of MacOS 8.5), then read Known problem 2.
Use Alfabetic Sorting
Items in the strip are sorted alfabeticaly, prior to HandyMan 2.0 this was the only way.
If this option is off sorting is based on the position of the Icons in the Finder Windows. HandyMan will organize your icons if you drop at a certain locations.
For this to work correct one must keep the HanyMan Folders closed in the finder.
Add Row/Column
In the Configuration menu you will see either メAdd Rowモ or メAdd Columnモ. The option displayed depends on how you have set the メShow Vertical icon listモ option in the Configuration menu. If it is not possible (メShow Multiple Rows/Columnsモ and メShow Aliases Folderモ must be checked), this option will be greyed out.
Update icon list
Will re-parse your configuration folder and update all links.
About HandyMan
Guess what...
Help
Brings up help via AppleGuide...
Registerノ
Only visible in an unregistered version.
Pops up a dialog box requesting your serial number. See the メRegistration Informationモ file for more info about how to register.
8. The Contextual menu
As of HandyMan 2.0 every item in the strip has a contextual menu. Click and hold on an entry to get it.
Launch/Open
same as just clicking on the entry
Delete Icon
removes the icon from the strip
Show Original
Shows the original icon in the finder
Holding down Option while selecting this will show you the alias in the HandyMan Folder
Finder Info
Shows the ヤGet Infoノユ window of the original item
Holding down Option while selecting this will show ヤGet Infoノユ for the alias in the HandyMan Folder
Empty Trash
Empties your trash.
9. About the Program
HandyMan is ゥ by 1995-99 Bert Wynants.
HandyMan is shareware. Check out the メHow to Registerモ to see how you can register.
HandyMan has proven to be stable in everyday use. The author is not responsible for any loss of data, damages to software or hardware that may result directly or indirectly from the use of this program. The author reserves the right to make changes to the software or documentation without notice.
None of the files of the HandyMan package may be modified. Crunching or archiving is allowed only if none of the HandyMan files get modified by it.
If you translate the program and send the translated version to me. I will use that translated version in new releases.
10. About the Author
Bugs, questions, or suggestions to:
Internet e-mail
bwynants@kagi.com
HomePage:
http://gallery.uunet.be/bwynants/
11. Acknowledgements
・ Aaron D. Ruiz, Aron S. Spencer, Boris Klug, Brian Renken, Kees Van Wijk, Christopher Li, David D. Kilzer, Drew Wade, Hans Verhoeven, Harry Ehrlich, Jan Dockx, Jeremy Keens, Karl Allison, Mason Loring Bliss, Michael Kisor, Michele Pizzi, Panos Philippakopoulos, Patrick Merel, Peter Frings, Steve Russillo, Steve Levinson and Wesley Summers for beta testing.
・ Wesley Summers for reworking and correcting the readme, history and examples text files!
・ Ammon Skidmore for all the help and for Extensions Strip.
・ Hisashi Nishimura and Michele Pizzi for all the work on the translated Readmes.
・ Christopher Li, Boris Klug, Michele Pizzi, Panos Philippakopoulos, Markus Gloede, Gjermund Gusland Thorsen and H渓an Liljegren for the Catalog Translations.
・ All those who have sent me a postcard!
12. Frequently Asked Questions (FAQs)
Q.1: Why doesn't drag and drop work?
A.1: Your system does not have the Macintosh Drag and Drop 1.1 extension, or your Finder isn't drag and drop aware. You should upgrade to at least Finder version 7.1.2 for the PowerMac or 7.1.3 for 68k Macs. Finder 7.1.3 comes with System 7 Pro, and Finder 7.1.4 comes with Mac OS version 7.5. If you do not have the correct software, you will not be able to drag Finder icons onto other icons. If you try, the icons will not highlight when you drag over them, and nothing will happen when you drop something on an icon. You can get Mac Drag & Drop 1.1 via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.
Q.2: Do I (really) need the scriptable Finder?
A.2: No, but if your system lacks the Scriptable Finder, some varieties of icons will not work. In fact, they usually won't be added to the strip. Folder icons, Trash icons, Control Panel icons, and ordinary documents require the Scriptable Finder in order to be fully operational. The Finder Scripting extension 1.2 comes with Mac OS version 7.5, or you can get it via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.
Q.3: You seem to indicate in the ReadMe file supplied with HandyMan that it is possible to have a number of folders (1,2 etc), in the Control Strip Module folder, with individual copies of HandyMan and HandyMan Aliases folders.
A.3: Yes this is possible. And each copy of HandyMan will run on it's own floating Window with it's own preferences. However you need to have Extensions Strip for this to work. See the Tips And Tricks section for more information.
Q.4: I noticed that my hard disks keep spinning a very long time just after (or during) startup. This does not happen if I de-install HandyMan. It doesn't seem to be that severe on a Power Mac 7100/66av where I also tested it. Is this known? Is there any remedy?
A.4: After startup, Handyman uses an idle time mechanism to get some more information about your installed applications. It goes out looking at what file types an application can open, so only drops of that kind are accepted. It uses the translation manager to do so, and if the Translation manager is not available, it uses a fall-back method. However this fall-back is not as fast as the Translation manager, so make sure Macintosh Easy Open is installed.
Q.5: Why can't I select メAdd Row/Columnモ from the Configuration menu?
A.5: Be sure you have selected メShow Multiple Rows/Columnsモ and メShow Aliases Folderモ from the Configuration menu.
13. Tips And Tricks
・ 1. If the option key conflicts with Control/Extensions Strip, press the mouse button first, then press the option key.
・ 2. To differentiate between folders, you can give them a label color in the Finder. Give folders that have the same icon a different label color in the Finder. HandyMan will display the icon in the same manner as the Finder after the icon display is updated. Select メUpdate icon listモ from the Configuration menu to update your HandyMan display immediately.
・ 3. As long as there are generic icons for documents or applications, HandyMan watches Disk Inserts and tries to get the icons from the desktop database of the inserted disks. If you have applications or documents that really have a generic icon you should paste a custom icon onto them to stop HandyMan scanning inserted disks (although it won't hurt watching the Disks).
・ 4. Put a HandyMan floating strip over your Trash, containing only a Trash, and configure it to show large icons. No more digging to find your Trash!
・ 5. To quickly spot a frequently accessed recent file, make it locked in the ヤRecent Documentsユ folder, HandyMan will underline it in the popup menu. Also see Known problem 2.
・ 6. If HandyMan tells you it is unable to resolve an alias, you can try to do ヤFind Originalユ in the Finder Info window for that alias. This often fixes the problem.
・ 7. Add the example Separator to the strip. This entry won't be clickable but gives you a nice separation bar. To position it, just give it a name that sorts between the two icons you want to separate or move it to the appropriate place when Alfabetic Sorting is off.
14. Known problems
1. Never put locked aliases into the ヤRecent files/folders/serversユ folders from ヤApple Menu Optionsユ with versions prior to Mac OS version 7.5.3. It will crash your system! Not a HandyMan issue but a nasty one.
2. Dragging an icon from HandyMan on a drag-able window of the current application or over the desktop when the Finder is in front fails (Drag Manager bug). I didn't remove the メEnable Drag Awayモ option because dragging an icon from handyman works very well if you stay in the strip, and can be useful to drop it onto one of the handyman icons (e.g. the Trash) or to reorder items. Due to this problem, dragging should currently be confined to within the strip module. This problem does not occur when using Extensions Strip or Control Strip 2.0 (part of MacOS 8.5).
3. If Alfabetic sorting is off, you have to close the メHandyMan Aliasesモ windows in the finder and it's subfolders or it won't work correct.